home *** CD-ROM | disk | FTP | other *** search
/ Aminet 4 / Aminet 4 - November 1994.iso / aminet / comm / uucp / wcnews_1_0_30.lha / man / active.times.man next >
Text File  |  1994-01-04  |  2KB  |  67 lines
  1.  
  2.  
  3.  
  4. ACTIVE.TIMES(5)                                   ACTIVE.TIMES(5)
  5.  
  6.  
  7. ›1mNAME›22m
  8.        active.times - newsgroup creation times and creators
  9.  
  10. ›1mDESCRIPTION›22m
  11.        The  ›4mactive.times›24m  file  records  the arrival of new news­
  12.        groups by time and creator.  This provides a quick way for
  13.        newsreaders  to tell when new groups have arrived, without
  14.        weird heuristics and  time/space  expensive  schemes  like
  15.        storing  old lists of newsgroups and comparing them to the
  16.        ›4mactive›24m file.
  17.  
  18.        When  a  new  newsgroup  is  created  by   C   News,   via
  19.        ›4m/usr/lib/newsbin/ctl/newgroup›24m                           or
  20.        ›4m/usr/lib/newsbin/maint/addgroup›24m, the group name,  time  of
  21.        group  creation,  and identity of the creator are appended
  22.        to the ›4m/usr/lib/news/active.times›24m file.  The time is  that
  23.        returned  by  ›4m/usr/lib/newsbin/maint/getdate›24m  and  on Unix
  24.        systems is the number of seconds since  January  1,  1970,
  25.        00:00, GMT.  The identity of the creator is taken from the
  26.        ›1mSender:›22m or ›1mFrom:›22m headers in the control message for groups
  27.        added  with  ›4m/usr/lib/newsbin/ctl/newgroup›24m,  and  from the
  28.        environment variable USER (if any; the default identity is
  29.        ``unknown'')       for       groups      created      with
  30.        ›4m/usr/lib/newsbin/maint/addgroup›24m.
  31.  
  32.        Each line in the file is of the form
  33.  
  34.             ›1mnewsgroup›22m ›1mcreation­time›22m ›1mcreator›22m
  35.  
  36.        The file must always be sorted in increasing order of  the
  37.        creation­time field.  The scripts only append to the file,
  38.        which normally suffices to ensure this.   (It  is  assumed
  39.        that time on the machine does not jump backward!)
  40.  
  41.        An  initial  version  of ›4mactive.times›24m for already existing
  42.        newsgroups, with all times equal to the time of  its  cre­
  43.        ation  and  all  creators  ``unknown'', can be built using
  44.        ›4m/usr/lib/newsbin/maint/act.to.times›24m (see ›4mnewsmaint›24m(8)).
  45.  
  46. ›1mFILES›22m
  47.        /usr/lib/news/active.times
  48.        /usr/lib/newsbin/maint/addgroup
  49.        /usr/lib/newsbin/maint/act.to.times
  50.        /usr/lib/newsbin/ctl/newgroup
  51.  
  52. ›1mHISTORY›22m
  53.        Conceived and implemented by Mark Moraes and Geoff Collyer
  54.        as part of the C News project.
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.                             8 May 1990                          1
  65.  
  66.  
  67.